home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / file / notify10.lha / Notify / Notify.doc < prev    next >
Encoding:
Text File  |  1994-12-19  |  2.2 KB  |  101 lines
  1.  
  2.  
  3.                                 Notify 1.00
  4.                                =============
  5.  
  6.                             Copyright © 1994 by
  7.  
  8.             Marc 'Nepomuk' Heuler <marc@aargh.incubus.sub.org>
  9.  
  10.  
  11. DISTRIBUTION
  12. ~~~~~~~~~~~~
  13.  
  14. Only non-commercial distribution allowed.
  15.  
  16. This package is MAILWARE.  If you use it, send an email to me.
  17.  
  18.  
  19. USAGE
  20. ~~~~~
  21.  
  22. Notify is a shell-only program.  It accepts those parameters:
  23.  
  24. NAME/A        Name of the directory or file that is to be monitored.
  25.  
  26. COMMAND        Command to execute when a change has been detected.
  27.  
  28. DELAY/N/K    Time in seconds to pass without further changes happening
  29.         before starting COMMAND is allowed.
  30.  
  31. STAY/S        Stay in memory after COMMAND is executed and coninue
  32.         monitoring.
  33.  
  34.  
  35. HINTS
  36. ~~~~~
  37.  
  38. For the purpose of consistency Notify does not pass-through the COMMAND's
  39. returncode.
  40.  
  41. Notify is halted while COMMAND executes (however it does not miss changes
  42. in STAY mode).  Use COMMAND="Run foo" to work around this behaviour.
  43.  
  44. As of Kickstart v40.38 and Workbench v40.23 append mode output redirection
  45. on existing files unfortunately does not trigger notification (at least in
  46. RAM:).  Same applies for deletion of files.
  47.  
  48. To stop a STAY-mode Notify from remote, use: Break `Status COM=Notify`
  49.  
  50.  
  51. EXAMPLES
  52. ~~~~~~~~
  53.  
  54. #1    Run Notify RAM: COMMAND="Echo *"Notification happened!*""
  55.     Echo >RAM:File "Test"
  56.  
  57. #2    Run Notify DOWNLOAD: COMMAND="RX TestNewArchives.rexx" DELAY=120 STAY
  58.  
  59. #3    (for CacheFont by Adam Dawes)
  60.  
  61.     Run Notify FONTS: COMMAND="MakeFontList" DELAY=120 STAY
  62.  
  63. #4    (a small network printer dispatcher)
  64.  
  65.     (because SKIP BACK doesn't work after EXECUTE, this script has)
  66.     (to be saved as "PRINTERDISPATCHER" in the path, s-bit set)
  67.  
  68.     (this script requires locale setting English)
  69.  
  70.     .KEY DIRECTORY/A,PRINTER/A
  71.     .BRA {
  72.     .KET }
  73.  
  74.     Lab Loop
  75.  
  76.     List >T:Print.{$$} "{DIRECTORY}"
  77.     If `List T:Print.{$$} LFORMAT="%l"` EQ "empty"
  78.      Notify "{DIRECTORY}"
  79.     EndIf
  80.     Wait 120
  81.     List >T:Print.{$$} "{DIRECTORY}" ALL FILES LFORMAT="Type >"{PRINTER}" *"%s%s*"*NDelete >Nil: *"%s%s*""
  82.     Execute T:Print.{$$}
  83.     Delete >Nil: T:Print.{$$}
  84.     Run >Nil: <Nil: PrinterDispatcher "{DIRECTORY}" "{PRINTER}"
  85.  
  86.  
  87. AUTHOR
  88. ~~~~~~
  89.  
  90. Marc 'Nepomuk' Heuler
  91. Stephanstr. 6
  92. 97070 Wuerzburg
  93. Germany
  94.  
  95. +49 931-53295
  96.  
  97. marc@aargh.incubus.sub.org
  98.  
  99. This package is MAILWARE.  If you use it, send an email to me.
  100.  
  101.